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Andy Beretvas 
Abstract 

This document is on Geant4 visualization tools (drivers), evaluating pros and cons of each option, 
including recommendations on which tools to support at Fermilab for different applications]!]. 

Four visualization drivers are evaluated. They are OpenGL, HepRep, DAWN and VRML. They 
all have good features, OpenGL provides graphic output with out an intermediate file! HepRep 
provides menus to assist the user. DAWN provides high quality plots and even for large files 
produces output quickly. VRML uses the smallest disk space for intermediate files. 

Large experiments at Fermilab will want to write their own display. They should proceed to 
make this display graphics independent. Medium experiment will probably want to use HepRep 
because of it's menu support. Smaller scale experiments will want to use OpenGL in the spirit of 
having immediate response, good quality output and keeping things simple. 



I. INTRODUCTION 



This report start with the sections Introduction, Documentation, Available Drivers, fol- 
lowed by a tour of Visualization. The tour shows plots produced by Geant4 using four 
different device drivers. The next section is on Building OpenGL a graphics device driver 
that produces immediate results. Followed by two further sections on OpenGL. We then 
treat graphic device drivers that require intermediate files. These are HepRep, DAWN and 
VRML. An important subsection is 'Summary of intermediate files'. The report concludes 
with Which driver to use?'. 

Very important to any experiment is a good way to visualize the results. To illustrate this 
obvious point I have selected an example from High Energy Physics (HEP). I was lucky to 
be able to play a part in the CDF display [2]. By looking at the central tracking display and 
seeing that there were very few high P t tracks in minimum-bias events, it was obvious that 
a fast trigger processor was needed for the experiment. The central tracking chamber is a 
cylindrical drift chamber located in a 1.5-T magnetic field provided by a super-conducting 
solenoid coaxial with the beam. Thus high P t tracks are almost straight lines. Jim Freeman 
and Bill Foster proposed and built the first fast trigger processor for the experiment. 

Equally true is that any experiment today needs a simulation. The total cross section 
for pp interactions at ^/i = 1800 GeV was measured by two groups CDF and E811[3]. One 
used a simulation(CDF) and one did not(E811). The results differ by about 2.8a. I along 
with some of my CDF collaborators wrote a report that indicated it was much better to 
have the simulation [4]. 

For any experiment it is always good if you can show a display and histogram for the 
experiment and the corresponding simulation. The context of different applications is very 
broad at Fermilab. Clearly the most important item on our agenda is the Linear Collider. 
Pier Oddone explains this in his "A vision for Fermilab" [5] . Physicist at SLAC are already 
using Geant4 in detector simulations for the Linear Collider. The CMS detector is shown in 
Fig. 1. The CMS experiment is currently rewriting it's software [6]. The new software will 
use Geant4. The older software called OSCAR also uses Geant4[7]. Geant4 has also been 
used to simulate a test of the Hadron Calorimeter which occurred in 2002. Of the current 
experiments MiniBooNE (see Fig. 2) is using Geant4. 

Some Fermilab physicist are involved in a planned experiment (MICE) at the Rutherford 
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FIG. 1: This is slide #24 from the talk by Pier Oddone showing the CMS detector. 
The CMS collaboration has 2000 members of which 300 are in the US. 

Appleton Laboratory involving muon cooling. The beam line for MICE has been simulated 
using Geant4. Cancer patients have been treated at Fermilab using hadron therapy for many 
years [8]. Fig. 3 is the first slide in a talk given by Arlene Lennox. 

Users at Fermilab include summer students working on medical applications [9]. To pro- 
vide answers for visualization over such a broad range of applications is a difficult question. 

Geant4 has done a very good job of making this question a little easier to answer by 
factoring the problem into visualization commands and drivers. The basic idea is that the 
visualization commands do not depend on the driver. Further it was hoped that once the 
code was built one could use any driver. The design was for the graphics systems to be 
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FIG. 2: This is slide #29 from the talk by Pier Oddone showing the MiniBooNE detector. 
The MiniBooNE detector has about 80 members. 

complementary to each other. Because of the factorization this report will be about the 
different drivers. 

II. DOCUMENTATION 

This report is based on running on the latest version of Geant4 version v4_7_l. Some of 
my experience has been with earlier versions v4_6_2_p02, v4_7_0, and v4_7_0_p01. During 
this time the Geant4 graphics system has been stable. Version v4_7_l was the first time I 
built an official Fermilab OpenGL version. 

To learn about Visualization in Geant4 I have used chapter 8 (Visualization) of the Geant 
User's Guide for Application Developers [10]. The visualization chapter also covers visual- 
ization of detector geometry trees. These are easy to use (RegisterGraphicsSystem (new 
G4ASCIITree); Idle> /vis/drawTree ! ATree), but are not relevant to our discussion on 
drivers. Visualization is also covered in a talk by Joseph Perl presented as part of a Geant4 
tutorial [11]. 
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HADRON THERAPY FOR CANCER TREATMENT 




Seminar presented by Arlene Lennox at Fermilab on Nov 21 , 2003 



FIG. 3: A very small group of people run the hadron therapy facility at Fermilab. 
III. AVAILABLE DRIVERS 

The list of drivers is given in Table 8.1 of the User's Guide. The 11 possible choices 
are DAWNFILE, DAWN-Network, HepRepFile, OpenGL-Xlib, OpenGL-Motif, OpenGL- 
Win32, Openlnventor-X, Openlnventor- Win32, Ray Tracer, VRMLFILE, VRML-Network. 

At Fermilab only Unix products are supported. At CERN there is support for running 
Geant4 under windows. Thus two choices are eliminated (OpenGL- Win32, Openlnventor- 
Win32). I have chosen not to investigate the network drivers. They are DAWN-Network, and 
VRML-Network. The Openlnventor drivers were developed at Fermilab by Jeff Kallenbach. 
At the present time no one is maintaining them. This eliminates Openlnventor-X from the 
list. Information about the Ray Tracer program can be found in the standard Geant4 source 
code[12]. The documentation for Ray Tracer says that only a limited set of commands are 
supported. Further, the README says "G4Ray Tracer can visualize absolutely all kinds of 
geometrical shapes which G4Navigator can deal with. Instead, it can NOT visualize hits 
nor trajectories generated by usual simulation" Ray Tracer it would seem would be valuable 
for finding problems in very complicated geometries. Because of it's inability to deal with 
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trajectories I have eliminated it. I have chosen to investigate OpenGL-Xlib, rather than 
OpenGL-Motif. In summary there are 4 general purpose drivers that will be investigated. 

The remaining four drivers are: OpenGL-Xlib, VRMLFILE, HepRepFile and DAWN- 
FILE. Thus I have run novice example3 with all of the four remaining drivers. Incidentally 
the talk by Joseph Perl is about three of the drivers (OpenGL, HepRepFile, DAWNFILE). 
The BTeV experiment (which included Rob Kutschke, Lynn Garren, Paul Lebrun, Julia 
Yarba, ...) would have used VRMLFILE. 



IV. TOUR OF VISUALIZATION 



A. OpenGL 



We start our tour with an OpenGL plot shown in Fig. 4. 



I nt rod u ctio n to Gsan t4 Vis u al izat ion 



3 March 2004 



OpenGL Runs Directly from Geant4 

With OpenGL, all commands go through Geanl4: 



vis/open OGLIX 
/vis/sceria'create 
/vis/scene/add /Volume 
/vis/scerieHari d ler/attac h 
/vis/viewer/flush 

N i s/v i ew er/set/v i ew p o i n tTh et a P h i 70 
/vis/vi ewer/zoom 2 
/vis/viewer/reset 

N i s/v i ew er/set/v i ew p o i n tTh et a P h i 40 

/vis/viewer/panTo -5 -1 

/vis/viewer/zoom 4. 

N i s/s cen e/ad d /t r aj ect o r i es 

/v i s/s cen e/ad d/hits 

/tracking/storeTrajectory 1 

/run/beam On 1 
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FIG. 4: This is an OpenGL plot shown by Joseph Perl at the SLAC Mar. 2004 tutorial. 



This is from a talk by Joseph Perl which was part of a Geant4 Tutorial held at SLAC 
in Mar.of 2004. The slide shows some typical Geant4 visualization commands. The first 
command /vis/open OGLIX opens the visualization driver. The title is very important 
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and indicates that OpenGL runs directly from Geant4. All other drivers (HepRepFile, 
DAWNFILE and VRMLFILE) produce an intermediate file. It's important to mention that 
the visualization code can be C++ source code or visualization commands. It's very nice 
to be in the interactive mode and see the display change. Sometimes you may mistype a 
command and you learn that right away. It's also important to realize that if you have many 
commands you can put them in a macro file (vis. mac). These commands can be executed 
at once by giving the command /control/execute vis. mac. Thus you can proceed efficiently 
in the interactive mode. 

OpenGL plots have also been produced at Fermilab. The following plot shown in Fig. 5 
created by V. Daniel Elvira is taken from our new Geant4 web page [13]. 

The web page has a section called pictures. Daniel's plot is a simulation of an electron 
showering in the CMS EM calorimeter. Another OpenGL plot produced at Fermilab is 
shown in Fig. 6. 

This plot was produced by a visitor Takeharu Ikema who worked on Medical Physics 
Applications. 

B. HepRep 

We continue our tour by again looking at another plot from Joseph Perl's talk (Fig. 7). 

This plot shows that HepRep is being used by many collaborations world wide. The 
plot in the upper left hand corner is made using JAS3 a general purpose, open-source data 
analysis tool. JAS is the abbreviation for JAVA Analysis Studio. The LCD indicates that 
this is a study for the Linear Collider Detector. Another important application for HepRep 
is the BeBar b-experiment at SLAC shown in the upper right corner. HepRep also serves 
the space community. GLAST is the Gamma Ray Large Array Telescope. The GLAST 
simulation is shown in the lower left hand corner. GLAST is scheduled to be launched in 
2006[14]. The lower right hand plot indicates that the Geant4 Web pages are maintained 
by using HepRep. 

At Fermilab we (Andy Beretvas, V. Daniel Elvira and Panagiotis Spentzouris) have agreed 
to support HepRep. The reasons for our decision are that HepRep has menu's to guide the 
user and is easy to install. Fig. 8 explains how using the WIRED client event display you 
can pick to show important features of the event (Particle ID, charge, momentum). 
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Geant4 picture of a CMS simulation 
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OpenGL image of a Geant4 simulation of the CMS Hadron Calorimeter Test Beam 
Experiment (2-002). Top plot is an angle view of the full Test Beam 2002 detector. 

Bottom Plot is a side view of the eCal and HB sections of the Test Beam 2002 
detector. In both plots the incident particle is a LOGeV electrom (image: V. Daniel 

Elvira) 



FIG. 5: This is an OpenGL plot shown by Daniel Elvira at the Fermilab Oct. 2003 tutorial. 



However, there are many reasons for this choice such as HepRep will work in a wider 
context. This is explained by Joseph Perl in Fig. 9. 



C. DAWN 



The next plot Fig. 10 shows a simulation of the ATLAS detector. Again the figure is 
taken from the talk by Joseph Perl. From the drawing the size of the detector is not clear. 
The detector is huge with a length of 45m and a height of 22m and contains more than 
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Bock to Geant4 at Fermi lab 



GeanM picture of a medical simulation 




OpenGL image of a Geant4 simulation of a patient being treated using a 65 MeV 
proton beam. Target is Be (yd low) and Collimator is Pb (silver) and patient is 
(gray )( image: Takeharu Ike ma}. 

FIG. 6: This is an OpenGL plot produced by Takeharu Ikema. 

million components[15]. 

I do not know of any Geant4 users at Fermilab who use DAWNFILE as a visualization 
driver. 

D. VRML 

Here is a slide from the BTeV collaboration (Paul Lebrun) showing a pixel detector 
Fig. 11. This Geant4 slide is produced using the VRML driver. 

The BTeV experiment was canceled in Feb. 2005[16]. An experiment which is currently 
running (2005) is MiniBooNE. This is an experiment to test for neutrino mass by searching 



9 



Inlioductled itsGranl4 VisuaUiailen 



. I. .r,l 



Who's Using HepRep 




FIG. 7: HepRep plots from a talk presented by Joseph Perl (Tutorial SLAC Mar. 2004). 

for neutrino oscillations [17]. Their GEANT4 simulation uses the VRML driver. A simulation 
of their beamline is shown in Fig. 12. 



E. Openlnventor 

Although I have decided not to include the Openlnventor driver in our discussions, I was 
very impressed with the following figure (Fig. 13) 

provided by Tom Roberts. This figure is also available from the Fermilab Geant4 web 
page. 

V. BUILDING OPENGL 

In order to use some Visualization Drivers an external library must be used. There 
are five such libraries (OpenGL-Xlib, OpenGL-Motif, Openlnventor-X, Dawn-Network, and 
VRML-Net Work) . Only one of then is among the 4 drivers we are investigating in this note 
(OpenGL-Xlib). The OpenGL version will be built for Fermilab users starting with v4_7_l. 
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FIG. 8: Picking important features of the event. 

Also taken from Joseph Perl's talk at SLAC Mar. 2004. 



The build was done with the following command: 
setenv G4VISJBUILD_OPENGLXJDRIVER 1 
To setup this version: 

setup geant4 v4_7_l -q GCC_3_4_3-OpenGL 

You should get the correct flavor for your machine (either Scientific Linux, or Red Hat 
Linux). To correctly use this version you will need to indicate that you wish to use OpenGL 
and to obtain the libraries, 
setenv G4VIS_USE_OPENGLX 1 

setenv OGLHOME /usr/XHR6 
setenv OGLFLAGS "-I$OGLHOME/include" 
setenv OGLLIBS "-L/usr/XllR6/lib -1GL -1GLU" 
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The HepRep interlace breaks "the dependency between any particular 
experiment's event display server and any particular event display client. 

The HepRep format is Independent of any one particular language or protocol. 
It can be used from C++ or Java and can be shipped as Corba. RMI, XML. C++, 
Java or JNI for consumption by WIRED. FRED or any other Hep Rep -enabled 
event display client. 

Joseph fbiI 13 



FIG. 9: HepRep is not just for Geant4 is the title of this slide. 
Also taken from Joseph Perl's talk at SLAC Mar. 2004. 



VI. PRODUCING A PLOT FROM OPENGL 



The first step is to produce an executable. In our example we use novice example N03. 
The instructions on doing this are documented on our web page [18]. 

Next we produce a picture of the detector. Note this is the sampling calorimeter with 
layers of Pb and liquid Ar detection gaps. We run the job in interactive mode (./exam- 
pleN03). To clearly indicate the commands I am using I have put them in a macro file. We 
next execute the macro 
Idle> /control/execute vis_OpenGL0.mac 
The macro file is shown in Fig. 14. 

This produces a new window with the picture of the detector. A saved image of the 
picture is produced by opening another window. The window which has just been opened 
should be also in the area which contains the executable. In this window you type 
xwd -out file.xwd 

The name of the file is arbitrary. I will refer to this as an xwd file. This will produce a 
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FIG. 10: DAWN is used to display a simulation of the ATLAS detector. 
Also taken from Joseph Perl's talk at SLAC Mar. 2004. 

cursor, which you should place over the window which contains the picture. The program 
convert is then used to change the format of the file, 
convert fileO.xwd ex3_detector_OpenGL0.jpeg 

I usually use a jpeg file for the web and an eps file for latex documents. The resulting plot 
is shown in Fig. 15. 

The size of fileO.xwd is 704 KBytes, and the size of the corresponding jpeg file is 51 
KBytes. The size of the xwd file is determined by the number of pixels in the window. We 
now make a few changes in the macro and draw a plot for an interaction in the calorimeter. 
The few changes include specifying the incident particle and it's energy. The macro file is 
given in Fig. 16. 

The resulting plot is shown in Fig. 17. 

On the screen the figure looks much better, because the green contrasts much better with 
the black (the black is not as intense as in the hardcopy). Geant4 uses the convention that 



13 



Pixel Geometry, One Station 




FIG. 11: Geant4 using the VRML driver is used to produce a picture 
of the proposed BTeV pixel detector. 

negatively charged tracks are plotted in red, neutral in green and positive in blue. The size 
of the file is again the same (704 KBytes) as expected and the size of the corresponding jpeg 
file is 64 KBytes. We now run a third job accumulating all the hits for 10 events. The size 
of the file is again the same (704 KBytes) and the size of the jpeg file is 70 KBytes. The 
resulting very complicated plot is shown in Fig. 18. 

The size of the corresponding eps files is in all three cases 2144 KBytes. The information 
on the sizes of the OpenGL files is summarized in Table: I. 

VII. PRODUCING MANY PLOTS FROM OPENGL 

The procedure described in the last section works well for a few plots, but real projects 
involve many plots. I am told by Don Holmgren that the Cryogenic Dark Matter people 
have developed a procedure using OpenGL and a virtual window to do this automatically. 
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Picture of t Lie MiniBooNE beamline ('imageiPanagiotis Spentzouris). 

FIG. 12: Geant4 using the VRML driver is used to produce a picture of the MiniBooNE beamline. 

TABLE I: Sizes in KBytes for the OpenGL files 

Name xwd jpeg eps 

Detector 704 51 2144 

Detector + 1 event 704 64 2144 
Detector + 10 events 704 70 2144 
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Back toGeani:4 at Fermi lab 



Geant4 picture of Muon Cooling simulation 




This is a plan view of the approved MICE beamline and experiment at the 
Rutherford Applet on Laboratory.lt includes 9 q_uadrupole magnets (blue and green), 
two bending magnets (red) and a two-cel l muon cooling channel in the lower right 
(yellow solenoids, red RF cavities, ending with a blue calori meter )( image: Tom 

Roberts tjrob@fnal.gov) 



FIG. 13: Simulation of MICE experiment using Openlnventor as the device driver (Tom Roberts). 



VIII. USING INTERMEDIATE FILES 



In principle you can use all drivers simultaneously. I have not yet tried this! First you 
must indicate which driver you are using. For the three drivers we will examine in detail 
the command is: 

setenv G4VIS_USE_HepRepFile 1 
setenv G4VIS_USE_DAWNFILE 1 
setenv G4VIS_USE_VRMLFILE 1 



The intermediate files have unique names in that the file is given an extension (.heprep, 
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Listing for vis_OfenGL0.mac 



# Macro file for thelnltmllzatton phase of "e\amfleN03cc" 

# WHEN RUNNING IN INTERACTIVE MODE 
# 

#Sets some default verbose 
/control/verbose 2 

/CONTRO LiS AVEHlSTO Rf 

/RUN/VERBOSE 2 

# 

# CREATE EMPTY SCENE 

/vis /scene/create 

# 

# Create a scene handler for a specific graphics system 

ATS/OPEN OGL1X 

* 

# Output an empty detector 
/v-le/viewer/5et/viewpolntThetaPhl40 SO deg 
/vis Ate ft er /flus h 

#XWD -OUT FLLEl 



Picture of the detector for ejuunpleN03 made with OpenGL 



FIG. 14: Example of a macro file used to produce an OpenGL plot. The plot shows the detector 
of novice example N03. 



prim, wrl) for (HepRepFile, DAWNFILE, VRMLFILE) respectively. 



A. Using HepRep 



I run a single macro file that is almost equivalent to the three macro file used for 
OpenGL. The macro as expected uses /vis/open HepRepFile. This produces three data 
files (G4Data0.heprep, G4Datal.heprep and G4Data2.heprep). The size of these data files 
are 71, 1705, 16626 KBytes. 

In order to proceed to look at these files the HepRep client file WIRED must be in- 
stalled. The instruction for installing WIRED are given on a SLAC web page [19]. I have 
installed wired in my own area on the FNALU Linux cluster and also on the cepa cluster 
( andy/Wired/bin/wired). Additional information that maybe useful can be found in the 
Fermilab dictionary of Geant4 terms [21]. You will also want to learn about the HepRep 
Browser. To bring up the browser type: 
andy/Wired/bin/wired dataJile[20] 

Information about the browser is available under Help -> Quick Browser the first page is 
shown in Fig. 19. 
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FIG. 15: The calorimeter of example N03 produced using OpenGL. 



The plots showing the detector, an interaction in the calorimeter and the superposition 
of 10 interactions are shown in Figures 20, 21 and 22. On immediately notices that the 
command /vis/viewer/set /viewpoint ThetaPhi is not implemented, but one sees a standard 
view of the detector. I should point out that rotations around the axis perpendicular to the 
screen are allowed and more (see information in the Quick Browser under " The Orientation 
Toolbar" ) . 

The way to produce a plot is to go to "File" and then "Export Graphics". I have recently 
encountered some difficulties with this and thus I have produced plots with xwd (see section 
on Producing a plot from OpenGL). Hep Rep keeps track of the files so that you can just 
click on the right arrow on the Main tool bar and it proceeds from the first file to the second 
file (G4Data0.heprep -> G4Datal.heprep). 



18 



Listing for V is_0 ffn GL Lmac 



## MACRO FILE FOR THE INITIALIZATION PHASE OF " EXAM FLEN03.CC" 
# WHEN RUNNING IN INTERACTIVE MODE 
/GUN/P ARTICLE E+ 



h UN/EN ERGf 300 MEV 
# 




/control/verbose 2 

/CONTRO L/S AYEHLSTO R~I 

/RUN/VERBOSE 2 

# 

# CREATE EMPTY SCENE 
/VLS/SCEN E/CRE ATE 



FIG. 16: How to produce a plot using OpenGL for an interaction in the calorimeter. 

It takes a relatively long time (82 sec on my machine which is a 500 MHZ Pentium III [22]) 
to go from the second plot to the third This is clearly caused by the large size of the file and 
the fact that HepRep requires much information to be stored in it's menus. As indicated 
earlier other information can be learned from the plots. For example that there are 469 
tracks in the event see Fig. 21. 

To set the material go to "Options" and then "Label Control" (see Fig 23). 

The resulting plot is shown in Fig. 24. 

One can see that the materials "lead: and "liquid Argon" appear on the plot, but to 
which region they refer is not so clear. 




# AT END OF EACH RUN. AN AUTOMATIC FLUSH CAUSES GRAFH1C AL OUTFUT. 
/RUN/HEAMON 1 



I -OUT FLLE2 



Picture of an interaction in the detector for eKampleN03 
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FIG. 17: A positron of 300 MeV incident on the detector of example N03 (OpenGL). 
B. Using DAWN 

The same macro is run as for HepRep, except for one command /vis/open DAWNFILE. 
This produces three data files (g4_00.prim, g4_01.prim and g4_02.prim). The size of the data 
files are 12, 235, and 2267 KBytes. Considerable smaller than the sizes of the HepRep files. 

Again to proceed further the DAWN client must be installed. This is available 
form the web site of Satoshi Tanaka one of it's developers [23]. To install you will 
need to answer some questions, I think the default answer will work. On the fnalu 
cluster (fTxi02,...) it is installed in andy /dawn/dawn and on the cepa cluster in 
andy/G4TEST/dawn_3_85e/PRIM_DATA/dawn. 

The plots showing the detector, an interaction in the calorimeter and the superposition 
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FIG. 18: The superposition of 10 events in the detector of example N03. 
Each event is initiated by a 300 MeV positron (OpenGL). 

of 10 interactions are shown in Figures 25, 
26 

and 27. 

One immediately notices that the command /vis/viewer/set /viewpoint ThetaP hi is now 
implemented. 

The DAWN job runs immediately because of the smaller sized files and that no menu 
information is needed. What immediately means is 5 sec for the 10 event file. In running 
DAWN I have used the -d option this is for the direct mode. Further information is available 
dawn -h (see Fig. 28). 
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Use the Open Data button to select some data. 

* To view data from a .hep rep file (as opposed to a serve.Tj, select either 
"Open HepRep File..." or "Open HepRep URL..." to open data on the 
local file system or over the web. 

For example, try the following URL to see some BaBar event data: 

tit tp : / / vrjw . 2 1 ac .at an f ord . edu / ~ ps r 1 / hspr s p:anl / BaBar _Exampl si . 1 

ot the following URL to see an EGS shower demo: 

tit tp e : f w\*\i . □ 1 ac .stacif ord . edu .---perl .' hepre p^ml .-' ecf sde irio . y*jn 1 . gz 



mem 



FIG. 19: The first page of help for the HepRepBrowser.. 
C. Using VRML 

The same macro is run as for HepRep, except for one command /vis/open VRML1FILE. 
This produces three data files (g4_00.wri, g4_01.wri and g4_02.wri). The size of the data files 
are 6, 141, and 1370 KBytes. Considerable smaller than the sizes of the HepRep files. 

Again to proceed further the VRML client must be installed. Information about VRML 
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FIG. 20: The calorimeter of example N03 produced using HepRep. 



can be found on the web [24]. It is produced by "Web3D Consortium- Open Standards for 
Real-Time 3D Communication Creators of the VRML (VRML1, VRML97, and now X3D, 
previously called VRML200x) open standards" . On cepa cluster the VRML client is in 
/home/prj/bphys/releases/dev/vrmlview. On the fnalu cluster(flxi02,...) it is installed in 
andy / vrmlview / vrmlview. 

The plot showing the detector is in Fig. 29 and was produced by going to File and then 
"Save snapshot". 

We continue with our standard Fig. 30 of a positron entering the calorimeter. 
This plot was produced by selecting under "View" "Wireframe" and "Vertices" . However, 
it is easy to select options that do not produce a useful figure (see Fig. 31). 
Our standard final plot is shown in Fig. 32. 
It takes 50 seconds for this plot to appear. 
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FIG. 21: A positron of 300 MeV incident on the detector of example N03 (HepRep). 



D. Summary of intermediate files 



The size of the intermediate data files is summarized in Table II. 



TABLE II: Sizes in KBytes for the intermediate files 



Name HepRep DAWN VRML 

Detector 71 12 6 

Detector + 1 event 1705 235 141 
Detector + 10 events 16626 2267 1370 



We see that if size is your major factor then VRML is the best choice and HepRep is 
the worst. In terms of menus to assist you HepRep is the best, the next best is VRML and 
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FIG. 22: The superposition of 10 events in the detector of exampleN03. 
Each event is initiated by a 300 MeV positron (HepRep). 

last is DAWN. In terms of time DAWN is a clear winner 5 sec versus 50 sec for VRML and 
82 sec for HepRep. In terms of quality plots DAWN is again the clear winner, followed by 
VRML and then HepRep. 

IX. WHICH DRIVER TO USE? 



The question of which driver to use was addressed by Joseph Perl. First he answers the 
list of what features are associated with each driver (see Fig 33). To complete his slide I 
present the results for VRML in Fig. 34. 

Perl also indicates the circumstances in which you want to use the different drivers in 
Fig. 35. 

At Fermilab we have three different types of users, large experiments (CMS) medium 
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FIG. 23: HepRep allows many options to be set including material. 



experiments (MiniBooNE) and small experiments (neutron therapy). 

The large experiments will want a structured environment. They may however, build it 
out of an environment that already has many of the tools like HepRep or they may want 
to proceed from a less structured environment like VRML. I strongly suspect that they will 
want their own graphics program. The Geant4 convention of only three colors (red, green, 
blue) for (neg, neutral, pos) is not what is needed for a modern high energy simulation 
program. One clearly needs different colors for electron and muons etc. The advice for the 
builders of a display for the Geant4 simulation program is to proceed exactly the way Geant4 
has done and produce a program that is device independent! It would be even better if the 
builders of such a display program could get thir code incorporated into Geant4. 

I suspect that medium sized experiments will want to go with HepRep because of the 
assistance provided by the menu's. 

Small experiments and starting students will want to use OpenGL because of it's quick 
response. It also my favorite in the spirit of keeping things simple. 

Clearly DAWN may be needed for publication quality work by large, medium and small 
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FIG. 24: HepRep plot with the short version of the label for material. 



experiments. 
In Tablelll 

I have attempted to summarized some of the important features for determining which 
device driver is right for you. The comparison of time and size of files is somewhat arbitrary 
when one compares the direct device driver and the those that use an intermediate file. I 
have left out the time required to produce the initial file for (HepRep, DAWN, VRML). 
Similarly I have not included the time to run OpenGL and produce the xwd file. 

All four drivers are available on the central cluster, and the Geant4-team will try to assist 
you in obtaining the different drivers [25]. The issue of support has changed dramatically 
recently because of a suggestion by GP Yeh. It is now possible to run Geant4 on your own 
personal computer (Linux pc)[26]. For pc user they will need to know how to obtain the 
client software. As this is all free software no serious problems are expected. 
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FIG. 25: The calorimeter of example N03 produced using DAWN. 
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FIG. 26: A positron of 300 MeV incident on the detector of example N03 (DAWN). 
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FIG. 27: The superposition of 10 events in the detector of exampleN03. 
Each event is initiated by a 300 MeV positron (DAWN). 

TABLE III: Graphics Summary 



Quality of plots 
Menus 
Time 



(1)= Best, (2) = Next Best 
1 2 3 



4 

HepRep 



DAWN OpenGL VRML 
HepRep VRML DAWN OpenGL 
OpenGL DAWN VRML HepRep 



Size of Files OpenGL(jpeg) VRML OpenGL(eps) DAWN HepRep 
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Information from dawn kelp (dawn -h> 



f f" A : A r A r \ T A~A~ A~ A~ #A~ <\~ : §'A : A~ = F r *" $ £ $ fl 1 # A'A? A* A ! A 7 A T 'A~ 'A- A- A' 

FUK.UL Renderer 
DAWN 

(Drawer for Academic Writings') 
ver 3. 85E-QL October 1?, 2003 



Option: 

-c Delete an old/lrrerevant parameter file. 

(Try to rescue DAWN from punic, anyway!) 

-d Direct mode, i.e., skip invoking the GUI panel. 

and use the previous parameters stored in the parameter file. 

in the current directory. 

-q Daemon mode (Unix domain ). 

-G Daemon mode (INET domain). 

-h Help L (options). 

-H Help 2 (env variables). 

-TSWAP ON/OFF OF FORCEIBLE WIREFRAME ATTRIBUTE OF EACH 3D PRIMITIVE. 
-V Q4.PRIM-F0RMAT VIEWER MODE (DEFAULT). 

Information: http ://geant4. k.ek . J p/- tan a ka 



FIG. 28: The help file for the DAWN display. 




FIG. 29: The calorimeter of example N03 produced using VRML. 
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Ready! 



FIG. 31: A positron of 300 MeV incident on the detector of example N03 (VRML). One can easily 
set the defaults such that the display is not useful. 

libG3Main.so and libG3Interface.so 
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[12] At Fermilab, setup Geant4 version 
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FIG. 32: The superposition of 10 events in the detector of exampleN03. 
Each event is initiated by a 300 MeV positron (VRML). 

setup geant4 v4_7_l -q GCC_3_4_3 and then go to 

/ products / geant4source / v4_7_l /NULL / geant4. 7. 1 / source / visualization/Ray Tracer /README. 
[13] Proposed New Fermilab Geant4 home web page. 

http:/ / cepa.fnal.gov/psm/geant4/index_ex.shtml 
[14] http:/ /www-glast. stanford.edu/mission. html 
[15] http://atlasexperiment.org 
[16] http://www-btev.fnal.gov 
[17] http://www-boone.fnal.gov 

[18] http://cepa.fnal.gov/psm/geant4/index_web/instructions_geant4_fermilab.html 
[19] SLAC web cite for installing WIRED 

ht tp : / / www . slac . st anfor d . edu /% 7Ewir edces / inst all .class 
[20] The data files are produced in the same directory as the exe file. 

It is convenient to set a variable to point to this area. 

setenv G4EXE andy/geant4/G4TEST_4_7_l JiepRep 
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The Various Visualization Drivers 

■ GpenGL 

- View di recti y from Geant4 

- Rendered, photorealistic image with some interactive features 

■ zoom, rotate, translate 

- Fast response (can usually expl oit ful I potential of graphics hardware) 

- Limited printing ability (pixel graphics, not vector graphics) 
Hep Rep File 

- View in the WIRED Event Display 

- Wireframe or simple area fil Is (not photorealistic) 

- Many interactive features 

■ zoom, rotate, translate 

■ click to show attributes (momentum, etc.) 
* special projections (Fish Eye, etc.) 

■ control visibility from hierarchical (tree) view of data 

- Export to many vector graphic formats (PostScript. PDF. etc.) 

■ DAWN FILE 

- View in the DAWN Renderer 

- Rendered, photorealistic image 

- Runs on Linux /Unix and Windows 

- No i nteractive features 

- Highest quality technical rendering - output to vector PostScript 

Joseph Ptirl 7 

FIG. 33: Features of the Visualization Drivers, OpenGL, HepRep and DAWN 

VRMLFILE 

View in the VRML "Viewer 
Runs on Unix 

Picture quality good, but not as good as DAWN 
Some Interactive features 

- Can change line width 

- Can rotate the object 

FIG. 34: Features of the VRML Visualization Driver 

data_file -> $G4EXE/G4Data0.heprep 
[21] The home page for the dictionary (List of Key Words) 

http:/ / cepa.fnal.gov/psm/geant4/key_word/Key -Words. html 
The page for detailed information on HepRep is: 

http:/ / cepa.fnal.gov/psm/geant4/index_vis/Visualization_HepRep.html 
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Choose the Driver that Meets your Current Needs 

• If you want very responsive photorealistic graphics (and have 
the necessary libraries installed) 

- OpenGL is a good solution 

(if you have the Motif extensions, this also gives GUI control 

• If you want GUI control, want to be able to pick on items to 
inquire about them (identity, momentum, etc.), and awirefram 
look will do 

- HepRep/WI RED will meet your needs 

• If you want to render highest quality photorealistic images for 
use in a poster or a technical design report, and you can live 
without quick rotate and zoom 

- DAWN is the way to go 

J.__ph Pari _ 

FIG. 35: When to use a given driver from Joseph Perl SLAC Tutorial. 

[22] To find the processing speed of your machine: 

cat /proc/cpuinfo 
[23] Web location of DAWN client: 

http:/ /geant4. kek.jp/ tanaka/src/dawn_3_85e.taz 
[24] htpp: //www. web3d.org/ 

[25] People who want to be informed about Geant 4 activities at Fermilab should subscribe to the 

FNAL mailing list GEANT4-USERS. 
[26] http:/ / cepa.fnal.gov/geant4/install/geant4_pc.shtml 



35 



